This section describes the uxset step command (UXSETSTEP on OS/400) used to define recovery steps within the Uproc's procedure. These steps may provide checkpoints from which the procedure may be restarted after an incident, without re-executing the entire Uproc.
The step numbers are recorded in the operations events file while the Uproc is executed. Therefore they provide a way to track the execution of a Uproc, as part of the dynamic job monitor function.
In the event of a restart, Dollar Universe prompts the user to enter the number of the step from which to restart the run (last step passed by default). The value of the step number entered is available in the Uproc's procedure, in the variable S_NUMJALON. This variable should be systematically tested in the procedure, and, depending on its value, the procedure should divert the procedure to the desired line.
The command syntax is as follows:
uxset step nn
Description of Items
nn
Step number. Passage through this step is time-stamped in the Dollar Universe Uproc history trace.
Format : 2 numeric characters
Example
This command inserted in the Uproc procedure will result in the line being marked as "step No 2". When executing the Uproc, the current step number will also be displayed on the job monitor screen.
uxset step 2
Examples of the use of recovery steps in ksh and csh procedures are included in the annexes to this guide.